CreateSwapToken

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODNameResolver

CreateSwapToken
The CreateSwapToken method creates a token that passes resolution of an object specifier to another part.
void CreateSwapToken (in ODOSLToken token,
                      in ODPart part,
                      in ODFrame frame);
token
A reference to the token to contain the part and frame information.
part
A reference to the part to be specified by the token.
frame
A reference to the frame to be specified by the token, or kODNULL if the specified part has no frames.

DISCUSSION
This method fills in the empty token you provide with information about the specified part and frame.
This method is intended to be called by your part's object accessors if they cannot handle the resolution of an object specifier, but know of another part that can (for instance, an embedded part). In this case, your object accessor can return a swap token to OpenDoc, which then tries to resolve the object specifier using the new part and frame.

EXCEPTIONS

kODErrOutOfMemory
There is not enough memory to create the token data structures.

SEE ALSO
The ODNameResolver::GetContextFromToken method (page 423).
The ODSemanticInterface::CallObjectAccessor method (page 595).
"Returning a Swap Token" on page 430 in OpenDoc Programmer's Guide.